<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python documentation Index' />
<link rel="first" href="lib.html" title='Python library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="node701.html" />
<link rel="prev" href="node699.html" />
<link rel="parent" href="node692.html" />
<link rel="next" href="node701.html" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>20.1.6.8 The index Parameter</title>
</head>
<body>
<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="20.1.6.7 bindings and Events"
  href="node699.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="20.1.6 handy Reference"
  href="node692.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="20.1.6.9 Images"
  href="node701.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node699.html">20.1.6.7 Bindings and Events</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node692.html">20.1.6 Handy Reference</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node701.html">20.1.6.9 Images</a>
</div>
<hr /></div>
</div>
<!--End of Navigation Panel-->

<h3><a name="SECTION0022168000000000000000">
20.1.6.8 The index Parameter</a>
</h3> 
<p>
A number of widgets require``index'' parameters to be passed.  These
are used to point at a specific place in a Text widget, or to
particular characters in an Entry widget, or to particular menu items
in a Menu widget.

<p>
<dl>
<dt><strong>Entry widget indexes (index, view index, etc.)</strong></dt>
<dd>Entry widgets have options that refer to character positions in the
text being displayed.  You can use these <tt class="module"><a href="module-Tkinter.html">Tkinter</a></tt> functions
to access these special points in text widgets:

<p>
<dl>
<dt><strong>AtEnd()</strong></dt>
<dd>refers to the last position in the text

<p>
</dd>
<dt><strong>AtInsert()</strong></dt>
<dd>refers to the point where the text cursor is

<p>
</dd>
<dt><strong>AtSelFirst()</strong></dt>
<dd>indicates the beginning point of the selected text

<p>
</dd>
<dt><strong>AtSelLast()</strong></dt>
<dd>denotes the last point of the selected text and finally

<p>
</dd>
<dt><strong>At(x<big>[</big>, y<big>]</big>)</strong></dt>
<dd>refers to the character at pixel location <var>x</var>, <var>y</var> (with
<var>y</var> not used in the case of a text entry widget, which contains a
single line of text).
</dd>
</dl>

<p>
</dd>
<dt><strong>Text widget indexes</strong></dt>
<dd>The index notation for Text widgets is very rich and is best described
in the Tk man pages.

<p>
</dd>
<dt><strong>Menu indexes (menu.invoke(), menu.entryconfig(), etc.)</strong></dt>
<dd><p>
Some options and methods for menus manipulate specific menu entries.
Anytime a menu index is needed for an option or a parameter, you may
pass in: 

<ul>
<li>an integer which refers to the numeric position of the entry in
the widget, counted from the top, starting with 0; 
</li>
<li>the string <code>'active'</code>, which refers to the menu position that is
currently under the cursor;
</li>
<li>the string <code>"last"</code> which refers to the last menu
item;  
</li>
<li>An integer preceded by <code>@</code>, as in <code>@6</code>, where the integer is
interpreted as a y pixel coordinate in the menu's coordinate system;
</li>
<li>the string <code>"none"</code>, which indicates no menu entry at all, most
often used with menu.activate() to deactivate all entries, and
finally,
</li>
<li>a text string that is pattern matched against the label of the
menu entry, as scanned from the top of the menu to the bottom.  Note
that this index type is considered after all the others, which means
that matches for menu items labelled <code>last</code>, <code>active</code>, or
<code>none</code> may be interpreted as the above literals, instead.
</li>
</ul>
</dd>
</dl>

<p>

<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="20.1.6.7 bindings and Events"
  href="node699.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="20.1.6 handy Reference"
  href="node692.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="20.1.6.9 Images"
  href="node701.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node699.html">20.1.6.7 Bindings and Events</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node692.html">20.1.6 Handy Reference</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node701.html">20.1.6.9 Images</a>
</div>
</div>
<hr />
<span class="release-info">Release 2.5.1, documentation updated on 18th April, 2007.</span>
</div>
<!--End of Navigation Panel-->
<address>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</address>
</body>
</html>
